Android 项目利用 Android Studio 和 Gradle 打包多版本APK

作者：给立乐*
出处：http://spencer-dev.com/2015/06/15/Android 项目利用 Android Studio 和 Gradle 打包多版本APK
声明：本文采用以下协议进行授权： 自由转载-非商用-非衍生-保持署名|Creative Commons BY-NC-ND 3.0 ，转载请注明作者及出处。

在项目开发过程中，经常会有需要打包不同版本的 APK 的需求。比如 debug版，release版，dev版等等。

有时候不同的版本中使用到的不同的服务端api域名也不相同。比如 debug_api.com，release_api.com，dev_api.com等等。不同的版本对应了不同的 api 域名，还可能对应不同的 icon 等。

如果每次都在打包前修改我们都手动来修改，这样实在是不够方便。
但如果我们使用了 Android Studio 和 Gradle，这个麻烦就可以轻松省去。

关于本文章的 Demo 项目，请参看这里 GradleBuildMultipleVersionAPK

具体方式如下：
在 Android Studio 中打开 build.gradle（Module中）的 android 节点下添加如下代码。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

buildTypes {
    //这里的名字自定义，不要求大小写
    release{
    
        // 这里是在 applicationId 中添加了一个后缀。所以『.』要加上
        applicationIdSuffix ".release" 
        
        // 这里的作用是选择是否混淆代码
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
    dev{
        applicationIdSuffix ".dev"
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
}
// 这里是为了不同过的版本设置一些特殊的参数，并不直接和 buildType 关联。
//例如：使用 buildType 中的 dev 版本，也可以使用 flavors_release 里面设置的自定义参数。这需要自己按照需求制定。
productFlavors{
//自定义名字不过不能和上面buildType中相同，不然Gradle编译会不通过。在这里使用了『flavors_』前缀以便区分。
    flavors_release{
    
    // manifestPlaceholders中写到的『str』，『package_name』不支持用大写，否则Gradle编译会不通过。
    // 这里所设置的变量可以直接使用在『AndroidManifest.xml』中，使用方式为：${package_name}
    // android:label="${package_name}" 
        manifestPlaceholders = [str:"releaseStr",package_name:"com.sunhz.mvptest.release"]
        // 这里的参数是为了在 java 代码中使用，具体的使用方式为：context.getResources().getString(R.string.strKey);
        resValue("string" , "strKey","releaseStrValue")
    }
    flavors_dev{
        manifestPlaceholders = [str:"devStr",package_name:"com.sunhz.mvptest.dev"]
        resValue("string" , "strKey","devStrValue")
    }
}

上面设置完成后，我们要在哪里使用它？

使用方式如下：
在 Android Studio 的工具栏中，找到『Build』项，找到『Generate
Signed APK…』，如下图。

选择 Module -> 创建 APK key，或者输入 APK key密码 -> 关键来了！如下图。

在『BuildType』处，选择我们在 build.gradle 中设置的两个 BuildType，分别是releas,dev,debug。其中『debug』为 Android Studio 自带的。

在『Flavors』处，选择我们在 build.gradle 中设置的两个Flavors，以方便直接使用定义在 build.gradle 中自定义的参数。

所以！ 上面我有提到说，buildType 和 Flavors 并没有直接的联系。
他们可以根据用户需求互相配合使用。如上图，BuildType 选择了 release，但 Flavors 选择的却是 flavors_dev。

到此基本的使用就全部说完了。

这里有一个问题，打出来的不同版本的包，全部都能够在同一部手机上安装，且能够将两个包全都发布到 Google 的市场上去这是为什么呢？

这里就要提到在 BuildType 中我们所设置的『applicationIdSuffix』属性了，按照这个属性的字面翻译为：『applicationId 的后缀』，那这里又来了一个问题，『applicationId』是什么？
其实这个『applicationId』属性，实际上在项目创建完成后就存在于 build.gradle 中。在 android 节点下的 defaultConfig 节点中。而且默认的 applicationId 和 AndroidManifest.xml 中的 package 属性相同。

如下图：

我们能够看到，这两个属性的默认值是相同的。

applicationId 和 packageName 它们是什么关系？

默认创建项目后，两者相同。如果需要根据不同的需求构建不同版本的APK，这时我们通过设置『applicationIdSuffix』可以做到。

这里有一个值得注意的现象。

举个例子，我们在打包时使用了 dev 类型，将打包出来的 APK 软件安装到手机中。

使用如下代码，获取我们手机上所有程序的packageName。

1
2
3
4
5
6

PackageManager packageManager = mContext.getPackageManager();
List<PackageInfo> packageInfoList = packageManager.getInstalledPackages(PackageManager.GET_PERMISSIONS);
List<String> packageNameList = new ArrayList<String>();
for (PackageInfo packageInfo : packageInfoList) {
    packageNameList.add(packageInfo.packageName);
}

我们打印出来的包名信息中，会出现 com.spencer_dev.test.dev 。并没有出现 com.spencer_dev.test 。

但是！
如果通过反编译工具，将 APK 包进行反编译直接查看源代码，在 java 代码所在的 src 目录中的包名，还和我们设置的一样，为 com.spencer_dev.test 。可 AndroidManifest.xml 中的 package 和 BuildConfig 类中的 APPLICATION_ID 已经变成了 com.spencer_dev.test.dev 。

applicationId 和 packageName 它们各自代表什么？

按照上面的结果来说， package 代表了 java 代码中的包名。 applicationId 代表了应用中的唯一标识。和应用签名一起用来区别和其他应用不同。我想这也就是为什么 Google 市场能够允许相同应用不同 applicationId 的原因。

关于更多的 applicationId 和 packageName 详解，请看这里。
ApplicationId 与 PackageName ， 作者：ChaosLeong

Comments: